AnnGetRotateOptions method (ILEADRasterAnnotation)

Syntax	short AnnGetRotateOptions(long hObject, long lFlags);
Overview	Refer to Implementing Annotations.

Remarks

(Document/Medical only) Gets the rotation options for the specified annotation object.

This function is one of the new functions being introduced as part of Version 14.5. Use this method to get the rotation options of any annotation object, including the automation object. The following properties will be updated after calling this method:

AnnShowRotateHandles property

With the new rotate options, two rotate handles are displayed on a selected object. One of the handles is the "gripper" handle, which rotates the object when dragged. The other handle is the "center" handle, which determines the center of rotation. The center of rotation can be moved by dragging. The gripper handle can be moved anywhere by dragging.

The following figure illustrates a rotate by dragging the "gripper" handle:

$image\gripper.gif$

The following figure illustrates moving the "center" handle:

$image\centerhandle.gif$

The rotate handles can be reset to a default location by right-clicking the annotation object, and selecting the Reset Rotate Handles option, as shown in the following figure:

$image\resetrotatehandles.gif$

The rotate handles can be globally hidden or displayed by right-clicking on the image (not an annotation object), and selecting the Hide Rotate Handles For All Objects option, as shown in the following figure:

$image\hiderotatehandles.gif$

Note:

In Version 14.5, you need to first enable this function by calling the AnnSetOptions method with the ANN_OPTIONS_NEW_ROTATE flag set. For more information, refer to New Annotation Features of Version 14.5.

Elements:	AnnSetRotateOptions method, AnnShowRotateHandles property
Topics:	Annotations (Document/Medical only): Object Manipulation
	New Annotation Features of Version 14.5